home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / blankery / blitzblank / docs / blitzblank.doc next >
Text File  |  1993-09-17  |  6KB  |  219 lines
  1. BlitzBlank 1.01
  2. ===============
  3.  
  4. ***************************************************
  5. * My FIDO-address has changed to 2:2476/506.11 !! *
  6. ***************************************************
  7.  
  8. What is it?
  9. -----------
  10.  
  11. Well, yet another screenblanker. But this one has the following features:
  12.  
  13. - AGA/OS 3.0 compatible
  14. - most modules graphic-cards compatible (tested with Picasso II)
  15. - modular (more modules to come, maybe one from YOU?)
  16. - fancy modules ;-)
  17. - nice GUI-interface
  18. - screenmode-requester built-in (because 2.0 ASL doesn`t have one)
  19. - ASL-filerequester
  20. - system-friendly
  21. - Commodity
  22. - mouseblanker included
  23. - copyrighted FreeWare
  24. - sourcecodes in BlitzBasic 2 included. Look at it, get ideas from it but
  25.   don`t change it!
  26.  
  27.  
  28. Copyright and warranty notice:
  29. ------------------------------
  30.  
  31. BlitzBlank is copyrighted by Thomas Boerkel. It must not be included with
  32. commercial programs (exception: BlitzBasic 2) and may not appear on
  33. PD/FD-disks with a cost of more than $5/DM 5.-.
  34. The right to include BlitzBlank in the Fred Fish Library is especially
  35. granted (and wanted ;-) ). This also applies to possible CD-ROM releases
  36. of the Library.
  37. You may copy and use BlitzBlank free with no cost (FreeWare).
  38. You may only distribute BlitzBlank with all files from the original archive.
  39. There is NO warranty! Use BlitzBlank at your own risk. The author is NOT
  40. responsible for ANY damage caused by BlitzBlank.
  41.  
  42. The same applies to all modules with the exception that they are
  43. copyrighted by their respective authors.
  44.  
  45.  
  46. What you need:
  47. --------------
  48.  
  49. - an Amiga ;-)
  50. - AmigaOS 2.04 or higher (if you have 1.x then upgrade NOW!)
  51.  
  52.  
  53. How to install:
  54. ---------------
  55.  
  56. It`s simple. Just copy BlitzBlank and BlitzBlank.info in your SYS:WbStartup
  57. drawer and the module-directory somewhere you like.
  58.  
  59. In this module-directory the BlitzBlank module-config-file
  60. "BB.Modules.config" will be automatically created.
  61.  
  62. BlitzBlank will then be started automatically at bootup.
  63.  
  64. Currently, BlitzBlank can only be started from WB.
  65.  
  66.  
  67. How to use:
  68. -----------
  69.  
  70. The first time you start BlitzBlank it will popup it`s window immediatly.
  71. You should change this after you made your configuration.
  72.  
  73. First, choose the correct path to the module-directory.
  74.  
  75. If you close BlitzBlank`s window, your changes will be remembered by
  76. BlitzBlank as long as it is not terminated.
  77. If you wish to make the changes permanent, click on the "Save"-button.
  78.  
  79. You can move through the different string-gadgets (text-fields) by pressing
  80. <TAB> and <SHIFT-TAB>.
  81.  
  82. All gadgets can be reached/used with the underlined key in the gadget`s
  83. label.
  84.  
  85. Because BlitzBlank is a commodity, you can also popup/close it`s window and
  86. terminate it with the System-Commodity "Exchange".
  87.  
  88. After you have configured a module, you HAVE to close the module`s
  89. config-window to make changes active.
  90.  
  91.  
  92. The GUI and its gadgets:
  93. ------------------------
  94.  
  95. Screen (key s/S):
  96. This pops up the Screenmoderequester where you choose your
  97. favourite screenmode and number of colors. Please note that all modules
  98. use the chosen screenmode but not all modules will use the chosen
  99. number of colors.
  100.  
  101. Test (key t/T):
  102. This lets you test the chosen module.
  103.  
  104. Config (key c/C):
  105. This calls the chosen module`s config-window.
  106.  
  107. Info (key i/I):
  108. This pops up a window with information about the chosen module.
  109.  
  110. Hide (key h/H/ESC):
  111. This closes BlitzBlank`s window.
  112.  
  113. Save (key s/S):
  114. This saves BlitzBlank`s current settings.
  115.  
  116. About (key a/A):
  117. This displays information about BlitzBlank.
  118.  
  119. Quit (key q/Q):
  120. This quits BlitzBlank.
  121.  
  122. Modules (key m/M):
  123. In this list you choose your module. Doubleclick on an entry calls
  124. the module`s config-window.
  125.  
  126. ModPri (key d/D):
  127. With this slider you choose the module`s task-priority.
  128.  
  129. Blankkey (key b/B):
  130. In this field you type in the key that should blank immediatly.
  131.  
  132. Path (key p/P):
  133. In this field you type in the path to the modules. You can also click
  134. on the drawer-gadget left from the field to get a filerequester. Or
  135. you press <HELP> while the field is activated.
  136.  
  137. Popup at startuptime (key u/U):
  138. Here you choose wether BlitzBlank should popup its window automatically
  139. at start.
  140.  
  141. Blank Mouse (key l/L):
  142. Here you choose whether your mousepointer should be blanked at a keypress
  143. and/or after a selectable amount of seconds.
  144.  
  145. Time (key e/E):
  146. In this field you type in the amount of seconds till the mousepointer
  147. should be blanked.
  148.  
  149. Popkey (key k/K):
  150. In this field you type in the key that should pop up BlitzBlank`s window.
  151.  
  152. Timeout (key o/O):
  153. In this field you type the number of seconds till BlitzBlank should
  154. activate a blankmodule. A number of 0 means that BlitzBlank will never
  155. blank.
  156.  
  157.  
  158.  
  159. How to program modules:
  160. -----------------------
  161.  
  162. Please refer to the Programmers.doc.
  163.  
  164.  
  165. Troubleshooting:
  166. ----------------
  167.  
  168. If a module seems not to work, then a lack of memory might be the cause,
  169. making it impossible for the module to open it's screen.
  170.  
  171. If BlitzBlank displays a requester telling you, that a module is not
  172. working, then maybe the module isn`t present any more or is damaged.
  173.  
  174. If you`re using XPK-XFH and you`ve problems with the saving of the
  175. module-configurations then get yourself the newest XPK-package
  176. (thanks to Brian Larson for telling me this)
  177.  
  178.  
  179. Bugs and suggestions:
  180. ---------------------
  181.  
  182. If you find any bugs or if you have any suggestions then please let me
  183. know. Tell me your EXACT configuration and the EXACT circumstances
  184. where you found the bug.
  185.  
  186.  
  187. The author:
  188. -----------
  189. Thomas Boerkel
  190. Gartenstrasse 16
  191. D-76761 Ruelzheim
  192. Germany
  193.  
  194. Mailbox:  Amiga Inside II, 07272/76611
  195. (Magicname "BLITZBLANK" for frequests)
  196.  
  197. FidoNet:  Thomas Boerkel, 2:2476/506.11
  198. AmyNet:   Thomas Boerkel, 39:172/302.0
  199. LifeNet:  Thomas Boerkel, 77:7700/11.11
  200. Usenet:   Thomas.Boerkel@mil.ka.sub.org
  201. RallyBox: Tom
  202.  
  203.  
  204. Thanks go to (in alphabetical order):
  205. -------------------------------------
  206. - Acid Software for the powerful BlitzBasic 2.
  207. - Andre Bergmann for betatesting, advice and the pre-V39-busypointer.
  208. - Wolfgang Boerkel for the Pyro-algorithm.
  209. - Commodore for the wonderful Amiga and it`s mighty OS.
  210. - Juergen Denner for betatesting, advice and the Lines-algorithm.
  211. - Michael Eberle for betatesting.
  212. - Bernd Ernesti for betatesting and ideas.
  213. - Stefan Scholl for betatesting and the tests on Picasso II.
  214. - Mathias Supp for betatesting and ideas.
  215. - Michael Weber for betatesting, ideas and the Aquarium-graphics.
  216. - Alexander Wiggert for betatesting, ideas, advice, correction-read of the
  217.   english docs and for pushing me forward.
  218.  
  219.